MediaPutMediaInfo(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / General Data Management

MediaPutMediaInfo
The MediaPutMediaInfo function allows your derived media handler to store proprietary information in its media.
pascal ComponentResult MediaPutMediaInfo (ComponentInstance ci,
                                           Handle h);
ci
Identifies the Movie Toolbox's connection to your derived media handler.
h
Contains a handle to storage into which your media handler may place its proprietary information. You determine the format and content of the data that you store in this handle. Your media handler must resize the handle as appropriate before you exit this function. Do not dispose of
this handle--it is owned by the Movie Toolbox. The Movie Toolbox uses the base media handler to write this data to your media.

DESCRIPTION
The Movie Toolbox uses the MediaPutMediaInfo function to provide you an opportunity to store private data in your media. You determine the format and content of this data. The base media handler stores some information for you, including the media's transfer mode, opcolor, and sound balance. However, you may need to store additional information. For example, you may want to place a version number in each media you create.
Whenever the Movie Toolbox opens your media, it provides this private data to your media handler by calling your MediaGetMediaInfo function, which is described next.
Note that the Movie Toolbox may call this function before it calls your MediaInitialize function.
Your derived media handler should support this function if you need to store private data in your media.

RESULT CODES
Any Component Manager result code